home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / clang / fpu_ae.zip / README.TXT < prev   
Text File  |  1990-12-12  |  9KB  |  200 lines
  1. --------------------------------------------------------------------------
  2. FPU_AE.LIB  für TURBO C (Atari-ST / TT)                         README.TXT
  3. Version 1.0                                               13.November 1990
  4.  
  5. Copyright: Adolf ENGL (C)           Barthgasse 9/18   A-1030 Wien  AUSTRIA
  6. --------------------------------------------------------------------------
  7.  
  8.  
  9.             *** INFORMATIONEN ZU FPU_AE.LIB (VERSION 1.0) ***                 
  10.  
  11.  
  12.  
  13. 1) PRODUKT-INFO:
  14.       "FPU_AE.LIB" ist eine Bibliothek für den C-Compiler "TURBO-C"
  15.     von Borland International (C) für alle ATARI-Modelle mit folgenden
  16.     Prozessortypen:
  17.  
  18.                 - MC68020 + MC68881 (FPU-Coprocessor) 
  19.                               oder
  20.                 - MC68020 + MC68882 (FPU-Coprocessor)
  21.                               oder                      
  22.                 - MC68030 + MC68881 (FPU-Coprocessor)
  23.                               oder
  24.                 - MC68030 + MC68882 (FPU-Coprocessor)
  25.                     
  26.     Dies sind beispielsweise die neuen ATARI-TT Modelle, oder auch die mit
  27.     diversen Erweiterungskarten (z.B PAK-68k mit MC68020/MC68881 von CT) 
  28.     aufgerüsteten ATARI-ST Modelle.
  29.         Vollkommen unbrauchbar ist diese Bibliothek für ATARI's ohne 
  30.     FPU-Coprocessor oder für ATARI-ST Modelle mit (nur) einem MC68000 
  31.     und einer Coprocessor-Zusatzplatine.
  32.     
  33.         Die "FPU_AE.LIB" soll als Ersatz der von Borland (C) mitgelieferten 
  34.     Flie₧kommabibliothek "TCFLTLIB.LIB" dienen. 
  35.     
  36.     Obwohl die Version 2.03 von TURBO-C nun schon brauchbaren Code für 
  37.     das Prozessorgespann MC68020/MC68881 erzeugt, beinhaltet die mitge-
  38.     lieferte Bibliothek "TCFLTLIB.LIB" nach wie vor (nur) Funktionen, die 
  39.     mit einem 80 Bit Format für [long] double rechnen. Die FPU-Coproces-
  40.     soren MC68881 und MC68882 von Motorola benötigen jedoch anstelle dieses
  41.     80 Bit Formates, ein 96 Bit Format für "extended precision real" 
  42.     Operanten. Ein 80 Bit Format wird von den Fpu-Coprocessoren keinesfalls
  43.     richtig verstanden und ein Aufruf von Funktionen aus "TCFLTLIB.LIB"
  44.     führt daher (bei Verwendung der FPU) bestenfalls zu unsinnigen Resul-
  45.     taten oder meist gleich zum Programmabsturz.
  46.     Borland schreibt dazu in der README Datei von Turbo C V2.x :
  47.        "... Programme,  die Flie₧kommafunktionen aufrufen, welche in der 
  48.         Bibliothek TCFLTLIB definiert sind, jedoch vom Coprozessor nicht 
  49.         unterstützt werden (z.B. printf(), scanf(), atof()),
  50.         sollten nicht mit dem Schalter -8 übersetzt werden."
  51.     Das bedeutet, benötigt man eine der in "TCFLTLIB" enthaltenen 
  52.     Funktionen, wie etwa printf() oder scanf() zur Flie₧komma-I/O, so mu₧
  53.     man auf den eingebauten FPU-Coprocessor verzichten und alles geht so 
  54.     langsam wie ohne FPU.
  55.     
  56.         Ein sinnvolles Arbeiten unter Verwendung von Flie₧kommazahlen 
  57.     mit einer der oben angeführten Systemkonfigurationen ist daher, 
  58.     alleine mit den von Borland mitgelieferten Bibliotheken, derzeit 
  59.     auch mit Turbo C V2.03 noch nicht möglich.
  60.     
  61.         Da sich die Turbo-C Entwickler(innen) bislang (seit August 90 ver-
  62.     spricht mir am Telefon ein freundlicher Herr von Borland München 
  63.     "sogleich" das entsprechende Update zu schicken) zur Herausgabe einer
  64.     brauchbaren Flie₧kommabibliothek nicht aufraffen konnten, habe ich 
  65.     nun als "erste Hilfe Paket" die "FPU_AE.LIB" entwickelt.
  66.     
  67.         Die Funktionen in der "FPU_AE.LIB" verwenden intern das, auch vom 
  68.     TURBO-C Compiler (bei der Verwendung des Schalters -8) für [long] double
  69.     erzeugte 96-Bit Format und verstehen sich daher prächtig mit den 
  70.     Motorola FPU-Coprozessoren.
  71.   
  72.     
  73. 2) Funktions - Umfang:
  74.         
  75.     Die Bibliothek "FPU_AE.LIB" umfa₧t folgende Funktionen:
  76.     
  77.     int printf( const char *format, ... );
  78.     int fprintf( FILE *stream, const char *format, ... );
  79.     int sprintf( char *string, const char *format, ... );
  80.         
  81.     int scanf( const char *format, ... );
  82.     int fscanf( FILE *stream, const char *format, ... );
  83.     int sscanf( const char *string, const char *format, ... );
  84.     
  85.     int vfprintf( FILE *stream, const char *format, va_list param );
  86.     int vprintf( const char *format, va_list param );
  87.     int vsprintf( char *string, const char *format, va_list param );
  88.     int vfscanf( FILE *stream, const char *format, va_list param );
  89.     int vscanf( const char *format, va_list param );
  90.     int vsscanf( char *string, const char *format, va_list param );
  91.             
  92.     char    *ecvt( double d, int ndig, int *dec, int *sign ); 
  93.     double  atof( const char *digStr );
  94.     double  strtod( const char *s, const char **endptr );
  95.     double  modf( double x, double *nptr );
  96.     double  ceil( double x );
  97.     double  floor( double x );
  98.     double  round( double x );
  99.     double  difftime( time_t time2, time_t time1 );
  100.     void    xdcnv( double *val, void *rep8bytes );
  101.     void    dxcnv( void *rep8bytes, double *val );
  102.  
  103.     Alle übrigen Standard-FPU-Funktionen werden direkt vom FPU-Coprozessor
  104.     unterstützt und sind in MATH.H ALS MAKROS definiert.
  105.    
  106.     
  107. 3) Produkt - Umfang:
  108.  
  109.    "FPU_AE.LIB" Version 1.0 besteht aus folgenden Dateien:
  110.        - fpu_ae.lib   ...  die eigentliche Bibliotheks-Datei
  111.        - math.h       ...  die zugehörige Include - Datei
  112.        - readme.txt   ...  das sollten Sie gerade lesen
  113.  
  114.  
  115. 4) Fehler:
  116.    Es wird NICHT für die fehlerfreie Funktion der Bibliothek garantiert.
  117.    Die Bibliothek wurde vorallem für den Eigengebrauch entwickelt und wurde
  118.    bislang nur auf einem ATARI-Mega-ST mit PAK-68k (mit MC68020/MC68881)
  119.    (spärlich) getestet. Fehler sind daher mit gro₧er Sicherheit zu erwarten.
  120.    Aber hoffentlich weniger als in den derzeitigen TC-Bibliotheken.
  121.       
  122.    Bewu₧te Einschränkungen:
  123.      - nachfolgende Nullen werden bei g-Format (printf()) nicht unterdrückt;
  124.      - keine eigene ftoa() - Funktion 
  125.  
  126.    
  127. 5) Installation:
  128.     
  129.    a) "fpu_ae.lib" in den TC-Library-Ordner kopieren; (im allg. nach "tc/lib")
  130.    b) "math.h" im TC-Includefile-Ordner durch das mitgelieferte "math.h"
  131.       ERSETZEN.
  132.       
  133.       
  134. 6) Verwendung:
  135.  
  136.    Für die Verwendung der Bibliothek "FPU_AE.LIB" sind folgende Punkte zu
  137.    beachten:
  138.               - Compiler-Option -2 und -8 EINSCHALTEN
  139.               - Assembler-Option -2 oder -3 EINSCHALTEN
  140.               - Assembler-Option -8 EINSCHALTEN
  141.               - in Projektdatei fpu_ae.lib anstelle von TCFLTLIB.LIB
  142.                 schreiben oder zumindestens fpu_ae.lib VOR TCFLTLIB.LIB
  143.                 anführen.
  144.  
  145.  
  146. 7) Verwendungsberechtigung:
  147.    
  148. a) Für die Verwendung der Bibliothek "fpu_ae.lib", oder von Teilen daraus,
  149.    in Programmen bzw. zur Erstellung von Programmen und sonstigen Soft-
  150.    wareprodukten ist KEINERLEI GEBÜHR zu entrichten, soferne es sich bei
  151.    diesen Programmen und sonstigen Softwareprodukten um solche für den
  152.    EIGENEN GEBRAUCH handelt, oder um Produkte, die UNENTGELTLICH an
  153.    Dritte weitergegeben werden, wie z.B. Public-Domain-Programme.
  154.  
  155. b) Die Verwendung der Bibliothek "fpu_ae.lib", oder von Teilen daraus,
  156.    in kommerziellen Produkten, das hei₧t in oder zur Erstellung von
  157.    Programmen und sonstigen Softwareprodukten für deren Weitergabe ein 
  158.    Entgelt verlangt wird, ist hiermit NICHT GESTATTET, sondern bedarf
  159.    einer eigenen Lizenzvereinbarung.
  160.    Diesbezügliche Anfragen richten Sie bitte an folgende Adresse:
  161.                    Adolf ENGL  
  162.                    Barthgasse 9/18 
  163.                    A-1030  Wien   Austria       
  164.  
  165. c) Das Produkt "FPU_AE.LIB" darf (und soll) beliebig oft und unentgeltlich
  166.    kopiert und an DRITTE weitergegeben werden, soferne immer ALLE UNTER 
  167.    Punkt (3) ("Produkt-Umfang") aufgelisteten Dateien in UNVERÄNDERTER Form
  168.    enthalten sind.
  169.    
  170.  
  171. 8) freiwilliger Entwicklungsbeitrag:
  172.    
  173.    Die Verwendung der "FPU_AE.LIB" ist, gemä₧ den unter Punkt (7) ("Verwen-
  174.    dungsberechtigung") angeführten Bestimmungen, KOSTENLOS gestattet.
  175.    
  176.    Falls Sie jedoch das Produkt gut gebrauchen können und deshalb auch die
  177.    Arbeit des Autors honorieren wollen, so können Sie einen Betrag Ihres
  178.    Ermessens als finanziellen Entwicklungsbeitrag an folgende Adresse senden:
  179.          Adolf Engl  Barthgasse 9/18   A-1030  Wien   Austria
  180.     
  181.   (Bitte übersenden Sie nur Banknoten und/oder Euroschecks. Euroschecks
  182.    bitte in Öster. Schillingen (Kürzel ÖS) ausstellen.)
  183.  
  184.    
  185. 9) Anregungen, Wünsche und Kritik:
  186.      
  187.      Diesbezügliche Mitteilungen senden Sie bitte an die Adresse des Autors
  188.    oder via eMail z.B. an Adolf Engl 2:310/3 im FidoNet.
  189.    
  190.    Bedenken Sie dabei bitte, da₧ diese Bibliothek nur als Uberbrückungshilfe
  191.    für all jene Leidensgenossen mit einer der anfangs beschriebenen System-
  192.    konfigurationen, dienen soll. Und vorallem nur solange bis Borland 
  193.    endlich ein besseres Turbo-C Update herausbringt.   
  194.    
  195.    
  196.                                   Mit freundlichen Grü₧en
  197.  
  198.                                          Adolf Engl
  199.                                          
  200.